Domain CREATE Request

Function

This request is used to register a domain.

Requirements

  • The request can only be processed if the domain has not already been registered.

  • Before registering the domain you must create the Contacts that are referenced in the request.

Verification

  • Domains in the “failed” state are initially bound to the 30-day connection period. After the connection, the risk assessment is carried out.

  • If a contact handle (type “PERSON” or “ORG”) with verified contact data is used, every domain registered with a domain CREATE request is automatically verified, provided that the verification result of the contact remains unchanged as “success”.

  • A domain CREATE request is also executed if contacts without a phone number or email address are used.

  • When the domain is passed to the risk assessment without one of the final statuses “connect” or “serverHold”, the domain status “pendingCreate” is set. An information message is output in the response.

Request Parameters

A Domain CREATE request is composed of the fields of the "Domain" data object and some other parameters, which are described below:

K/V Keyword XML Namespace and Element Occurrence
min - max		 Type / Length Value Range Description
Action domain:create 1 enumeration create-erule This is the request type.
Version - 1 enumeration version-erule This is the version. The keyword is only relevant for requests in the key/value format.
CtId ctid 0 - 1 token
3 - 64		 Any visible Unicode character (according to Unicode version 3.1) This is the unique transaction ID which is issued by the client.

Common Mistakes

  • The requested domain already exists.
  • The status of the requested domain is „redemptionPeriod“.
  • One of the Contacts stated in the request does not meet the requirements of the role to be assigned to it.
  • The Nameserver Predelegation Check failed. You will find descriptions of the checks that are executed in the DENIC document DENIC-23.

 

Examples

Copy

request:domainCREATE
format:kv

Version: 5.0
Action: CREATE
Domain: domain-example-nserver.de
Holder: DENIC-1000022-EXAMPLE-PERSON
Generalrequest: DENIC-1000022-EXAMPLE-GR
Abusecontact: DENIC-1000022-EXAMPLE-ABUSE
Nserver: ns1.denic.de
Nserver: ns2.denic.de
ctid: cba-987654321
Copy

response:domainCREATE
format:kv

RESULT: success
INFO: 53000080014 Domain "Status" is "pendingCreate"
STID: 3727d839-497f-4ef9-8aa5-0a1ea16a8c95
CTID: cba-987654321

 

Copy

request:domainCREATE
format:xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<registry-request xmlns="http://registry.denic.de/global/5.0" xmlns:domain="http://registry.denic.de/domain/5.0" xmlns:dnsentry="http://registry.denic.de/dnsentry/5.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <domain:create>
    <domain:handle>domain-example-nserver.de</domain:handle>
    <domain:contact role="holder">DENIC-1000022-EXAMPLE-XML-PERSON</domain:contact>
    <domain:contact role="abusecontact">DENIC-1000022-EXAMPLE-XML-GR</domain:contact>
    <domain:contact role="generalrequest">DENIC-1000022-EXAMPLE-XML-ABUSE</domain:contact>
    <dnsentry:dnsentry xsi:type="dnsentry:NS">
      <dnsentry:owner>domain-example-nserver.de</dnsentry:owner>
      <dnsentry:rdata>
        <dnsentry:nameserver>ns1.denic.de</dnsentry:nameserver>
      </dnsentry:rdata>
    </dnsentry:dnsentry>
    <dnsentry:dnsentry xsi:type="dnsentry:NS">
      <dnsentry:owner>domain-example-nserver.de</dnsentry:owner>
      <dnsentry:rdata>
        <dnsentry:nameserver>ns1.domain-example-nserver.de</dnsentry:nameserver>
        <dnsentry:address>81.91.170.12</dnsentry:address>
      </dnsentry:rdata>
    </dnsentry:dnsentry>
  </domain:create>
  <ctid>xml-74ba5155</ctid>
</registry-request>
Copy

response:domainCREATE
format:xml

<?xml version="1.0" encoding="UTF-8"?>

<registry-response xmlns="http://registry.denic.de/global/5.0" xmlns:tr="http://registry.denic.de/transaction/5.0">
  <tr:transaction>
    <tr:stid>a503e644-635c-4253-b598-84d0c2296a97</tr:stid>
    <tr:ctid>xml-74ba5155</tr:ctid>    
    <tr:result>success</tr:result>
    <tr:message level="info" code="53000080014">
      <tr:text>Domain "Status" is "pendingCreate"</tr:text>
    </tr:message>
  </tr:transaction>
</registry-response>